MathEngine Toolkits v0.2.0 Beta
-------------------------------

This release contains the MathEngine Toolkits v0.2.0 Beta release,
which includes:

-- Dynamics Toolkit 2.0 
-- Collision Toolkit 1.0.

The MathEngine Renderer (MeViewer2) is included to provide basic rendering
and a user interface for the example programs. MeViewer2 supports both 
the OpenGL and DirectX (version 7.0) APIs.
Demo executables and example source code are also provided.

NOTE: Please read the license agreement in the file named License before 
using any of the software in this distribution.

The target runtime and developer platforms for these toolkits are 
Windows 98, Windows 2000, Linux, PlayStation2 and Irix. Note that 
because Windows NT only supports DirectX up to version 3.0, it will 
only run the example programs under OpenGL.

You may however install the DirectX7.0 SDK on NT machines, which will allow
you to compile ME with DirectX7, but without enabling you to run it.


Downloading the Toolkits
------------------------

Platform-specific archives are available for download from one of the 
following MathEngine webpages:

	http://www.mathengine.com/corporate/download.html
	http://www.mathengine.com/games/download.html
	http://www.mathengine.com/VisSim/download.html

Untar or unzip the appropriate archive file for your platform into an empty 
directory.

Documentation
-------------

Documentation for all toolkits are in the doc directory.

The documentation includes:

-- Overview Document
-- Simulation Toolkit Developer's Guide
-- Simulation Toolkit Reference Manual
-- Dynamics Toolkit Developer's Guide
-- Dynamics Toolkit Reference Manual
-- Collision Toolkit Developer's Guide
-- Collision Toolkit Reference Manual
-- Viewer Toolkit Developer's Guide
-- Utility Reference Manuals
	* Message Handler
	* Definitions & Tools
	* File System
-- Demo Documentation

The documentation is browser-based, and consists of PDF files and HTML files.

Accordingly, you will need a Web browser and Adobe Acrobat Reader.
You can download Acrobat Reader from http://www.adobe.com.
You can download browsers from http://www.netscape.com and 
http://www.microsoft.com.
 
Start doc/index.html to view the home page for the documentation. 

See also the release notes in doc/ReleaseNotes for details of what is new 
and what has changed since v0.0.4.

Additional or updated documentation will be made available through the
MathEngine web site. See http://www.mathengine.com/metk/doc.

Example Programs and Demos
--------------------------

The bin directory contains executables for all demos, examples and tutorials.

For the example programs and demos:
-- F1  displays/hides Help for the example program.
-- F12 displays/hides Help for the MathEngine Viewer.

Toolkit Files
-------------

The include directory contains all the include files for all Toolkits,
and the lib directory contains all the libraries.

The src/components directory contains subdirectories for each module for which
source code is provided:

-- Mdt         - the Dynamics Toolkit
-- Mst         - the Simulation Toolkit
-- MeApp       - an application framework
-- MeGlobals   - various utilities
-- MeMessage   - the Message Handler utility
-- MeViewer2   - the Viewer Toolkit

The source code for the example and tutorial programs is located in the 
src/examples and src/tutorials directories respectively.

Contacts
--------

See the following MathEngine websites:
    http://www.mathengine.com - corporate s website

Or email:
    sales@mathengine.com    - for sales information
    support@mathengine.com  - for technical support using the Toolkits

